home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / rexx / PGPwithYAM.readme < prev    next >
Text File  |  1997-09-05  |  7KB  |  200 lines
  1. Short:    Easy use of PGP with YAM, update 1.5
  2. Author:   e9525802@student.tuwien.ac.at (Michael Praschl)
  3. Uploader: e9525802@student.tuwien.ac.at (Michael Praschl)
  4. Version:  PGPwithYAM 1.6
  5. Type:     util/rexx
  6. Requires: Workbench V39+, MUI3.8+, YAM, PGP 2.6.3(i)
  7.  
  8.  
  9. UPDATING
  10. This version uses SelectPGPKey V1.1. SelectPGPKey is Copyright © by  Juergen
  11. Kempkes  <rp10916@online-club.de>. Please contact him, if you want to use it
  12. in your own projects.
  13.  
  14. This has the advantage that you don't need setting pubword  anymore  in  the
  15. scripts. It's also has a nicer GUI.
  16.  
  17.  
  18. INTRODUCTION
  19.  
  20. The use of PGP is not easy for beginners, and also  if you are used  to  the
  21. commands of PGP, you have to use it manually, what is uncomfortable.
  22.  
  23. If you want to sign or encrypt an email, you had to write you text with  any
  24. editor,  encrypt  the  text (you have to know the user-id of the recipient),
  25. start your favorite mailer and include the encrypted text.
  26.  
  27. Why not write the text for your friend  with  the  mailer  (YAM)  and  sign,
  28. encrypt, sign & encrypt or read the mail with an arexx-script and select the
  29. recipient's user-id from an requester?
  30.  
  31. These arexx-scripts and commands give you the possibility to do such  things
  32. very easily.
  33.  
  34.  
  35. REQUIREMENTS
  36.  
  37. As I think anybody who uses his Amiga seriously has WB39, it's required  :-)
  38. If  you  don't have V39, GRADE UP! We live in the nineties. (One should have
  39. V46 by now, but it's not available:-(((
  40.  
  41. Same goes for MUI. If you're using YAM, the sublibraries  of  MUI  that  are
  42. needed by SelectPGPKey are loaded already.
  43.  
  44. It seems that PGP versions previous to 2.6.3(i) do  not  understand  the  -@
  45. option  which I use to read the recipient's ids, so you should upgrade to at
  46. least this version.
  47.  
  48. And of course you need YAM.
  49.  
  50.  
  51. INSTALLATION
  52.  
  53. Easier than it looks!
  54.  
  55. Copy all files except  the  .readme  to  YAM:rexx. Now  you  have  to  edit
  56. all the scripts.
  57. Change the variables: pgppath, userid and pubword
  58.  
  59. userid = 'Michael Praschl': Give your name here,  if  you  want  to  encrypt
  60. messages  with your key, too, so that you can read them when they are in the
  61. send-folder of YAM.
  62.  
  63. pgppath: set this to the path, where your pgp-executeable is.
  64.  
  65. Now edit YAM:.config and make the following entries in the last lines:
  66.  
  67. RexxMenu0       = YAM:rexx/SignMail.rexx
  68. RexxMenu1       = YAM:rexx/EncryptMail.rexx
  69. RexxMenu2       = YAM:rexx/SignEncryptMail.rexx
  70. RexxMenu3       = YAM:rexx/ReadMail.rexx
  71.  
  72. Then you have the scripts in the arexx menu of YAM.
  73.  
  74. You should also set the pager to Multiview or MuchMore in pgp:config.txt:
  75. Pager = "c:more"
  76. This is not necessary, but helps you when reading encrypted mails.
  77.  
  78.  
  79. USAGE
  80.  
  81. Signing a mail:
  82. Select the mail to sign and select Sign.rexx from  the  menu.  You  will  be
  83. prompted to enter the mantra of your pgpkey in a window where pgp makes it's
  84. input/output.
  85.  
  86. Encrypting a mail:
  87. Select the mail  to  encrypt  and  select  Encrypt.rexx  from  the  menu.  A
  88. requester will show you all public keys you have. You may select one or more
  89. keys. This requester was done with MUI. Then you  will  have  to  enter  the
  90. mantra  of  your pgpkey. If you closed the requester, pgp will ask you for a
  91. receipient's id after you entered your mantra.
  92.  
  93. Signing and encrypting a mail:
  94. Select the mail and SignEncryptMail.rexx ... (You should know how it works).
  95.  
  96. Read an encrypted mail:
  97. To read an encrypted mail select the mail to read  an  select  ReadMail.rexx
  98. from  the  menu  (yawn).  When  you  have  set you pgp-pager to Multiview or
  99. Muchmore or something similar, the plaintext will  be  displayed  with  this
  100. proggy.
  101.  
  102. This package will be obsolete, with YAM release V2.0
  103.  
  104.  
  105. NO WARRANTY
  106.  
  107. There is no warranty for the programs, to the extent permitted by
  108. applicable law. Except when otherwise stated in writing the copyright
  109. holder and/or other parties provide the programs "as is" without warranty
  110. of any kind, either expressed or implied, including, but not limited to,
  111. the implied warranties of merchantability and fitness for a particular
  112. purpose. The entire risk as to the quality and performance of the programs
  113. is with you. Should the programs prove defective, you assume the cost of
  114. all necessary servicing, repair or correction.
  115.  
  116. In no event unless required by applicable law or agreed to in writing will
  117. any copyright holder, or any other party who may redistribute the programs
  118. as permitted above, be liable to you for damages, including any general,
  119. special, incidental or consequential damages arising out of the use or
  120. inability to use the programs (including but not limited to loss of data or
  121. data being rendered inaccurate or losses sustained by you or third parties
  122. or a failure of the programs to operate with any other programs), even if
  123. such holder or other party has been advised of the possibility of such
  124. damages.
  125.  
  126. (Just to feel good)
  127.  
  128.  
  129. LEGAL
  130.  
  131. PGPwithYAM.lha is Public Domain. You may use all programms  and  sources  as
  132. you want.
  133.  
  134. Exception: This package must not be used by military. (smile)
  135.  
  136. SelectPGPKey is Copyright © by Juergen Kempkes  <rp10916@online-club.de>.
  137. Please contact him if you want to use it for your own projects.
  138.  
  139.  
  140. HISTORY
  141.  
  142. V1.0 first release, 18-Jun-97
  143.  
  144. V1.1 24-Jun-97
  145.      fixed a bug in SignMail.rexx
  146.      added version strings
  147.      changed docs a bit
  148.  
  149. V1.2 2-Jun-97
  150.      fixed the bug that destroyed the original mail, if something went wrong
  151.  
  152. V1.3 6-Jul-97
  153.      minor bugfixes
  154.      SignMsg.rexx does now use -t option, so text is readable on systems that
  155.        have set textmode=off in config.txt
  156.  
  157. V1.4 10-Jul-97
  158.      it's now possible to encrypt messages with your own key, too. This makes
  159.        it possible for you to read encrypted messages in the sent-folder.
  160.  
  161. V1.5 11-Jul-97
  162.      added a done-button to SelectKey-requester. This makes it easier to select
  163.        more than one receipient
  164.  
  165. V1.6 13-Jul-97
  166.      replaced SelectKey with SelectPGPKey by Juergen Kempkes.
  167.  
  168.  
  169. AUTHOR
  170.  
  171. If you find some bugs or have some suggestions, free feel to contact me:
  172.  
  173. Snail:
  174.   Michael Praschl
  175.   Hohe Warte 7-1-5
  176.   1190 Wien
  177.   AUSTRIA
  178.  
  179. Email:
  180.   e9525802@student.tuwien.ac.at
  181.  
  182. You can find a BIG project of mine at:
  183.   aminet:gfx/misc/proren.lha
  184.  
  185.  
  186. ============================= Archive contents =============================
  187.  
  188. Original  Packed Ratio    Date     Time    Name
  189. -------- ------- ----- --------- --------  -------------
  190.     1170     569 51.3% 13-Jul-97 10:19:58  EncryptMail.rexx
  191.     6135    2829 53.8% 13-Jul-97 10:07:24  PGPwithYAM.readme
  192.      561     336 40.1% 02-Jul-97 09:49:34  ReadMail.rexx
  193.     8504    4067 52.1% 13-Jul-97 09:47:52  SelectPGPKey
  194.     1240     583 52.9% 13-Jul-97 10:20:16  SignEncryptMail.rexx
  195.      785     428 45.4% 06-Jul-97 13:13:04  SignMail.rexx
  196.     2463     981 60.1% 18-Jun-97 19:28:00 +SplitMail.e
  197.     3188    1674 47.4% 18-Jun-97 19:27:46  SplitMail
  198. -------- ------- ----- --------- --------
  199.    24046   11467 52.3% 15-Jul-97 11:57:50   8 files
  200.